<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" Content="text-html; charset=Windows-1252">
<title>Button parameter</title>
<style>@import url(coUA.css);</style>
<link disabled rel="stylesheet" href="htmlhelp.css">
</HEAD>

<BODY>
<h1>Button parameter</h1>

<p>Use the <b>Button</b> parameter to create a button that will invoke a command when clicked. You can select from several button styles.</p>

<h2>Applies to</h2>
<a href=ocx_alink.htm>ALink</a><br>
<a href=ocx_close.htm>Close</a><br>
<a href=ocx_hh_version.htm>HH Version</a><br>
<a href=ocx_klink.htm>KLink</a><br>
<a href=ocx_relatedtopics.htm>Related Topics</a><br>
<a href=ocx_shortcut.htm>Shortcut</a><br>
<a href=ocx_tcard.htm>TCard</a><br>
<a href=ocx_winhelp.htm>WinHelp</a><br>

<h2>Valid values</h2>
<p>When clicked, the following example buttons each call the <b>HH Version</b> command.<p>
<table border=1 cellpadding=5>
<tr>
<th>
Syntax
</th>
<th>
Description
</th>
<th>
Example
</th>
<th>
Notes
</th>
</tr>

<tr>
<td>
<code>&lt;PARAM name="Button" value="Text:<i>button text</i>"&gt;</code>
</td>
<td>
Button with a text label.
</td>
<td align="CENTER">
<OBJECT
  id=chiclet
  type="application/x-oleobject"
  classid="clsid:adb880a6-d8ff-11cf-9377-00aa003b7a11"
  width=100
  height=100
>
    <PARAM name="Command" value="HH Version">
    <PARAM name="Button" value="Text:Example button text">
</OBJECT>

</td>
<td>You can enter text of any length for the label. The text will not wrap.
</td>
</tr>

<tr>
<td> <code>&lt;PARAM name="Button" value=""&gt;</code>
</td>
<td>
"Chiclet" button.  
</td>
<td align="CENTER" valign="MIDDLE">
<OBJECT id=chiclet type="application/x-oleobject"
        classid="clsid:adb880a6-d8ff-11cf-9377-00aa003b7a11"
        width=100
        height=100
>
    <PARAM name="Command" value="HH Version">
    <PARAM name="Button" value="">
</OBJECT>

</td>
<td>To specify a chiclet button, you can remove the Button parameter entirely or use empty quotation marks (<code>value=""</code>).
</td>
</tr>

<tr>
<td><code>&lt;PARAM name="Button" value="Bitmap:shortcut"&gt;</code>
</td>
<td>
Button with a shortcut icon.  
</td>
<td align="CENTER" valign="MIDDLE">
<OBJECT id=bitmap type="application/x-oleobject"
        classid="clsid:adb880a6-d8ff-11cf-9377-00aa003b7a11"
        width=100
        height=100
>
    <PARAM name="Command" value="HH Version">
    <PARAM name="Button" value="Bitmap:shortcut">
</OBJECT>


</td>
<td>...
</td>
</tr>

<tr>
<td><code>&lt;PARAM name="Button" value="Bitmap:<i>path to .bmp file</i>"&gt;</code>
</td>
<td>
Button with a bitmap image.  
</td>
<td align="CENTER" valign="MIDDLE">
<OBJECT id=bitmap type="application/x-oleobject"
        classid="clsid:adb880a6-d8ff-11cf-9377-00aa003b7a11"
        width=100
        height=100
>
    <PARAM name="Command" value="HH Version">
    <PARAM name="Button" value="Bitmap:bmpbutton.bmp">
</OBJECT>


</td>
<td>You can specify an absolute or relative path.
</td>
</tr>

<tr>
<td><code>&lt;PARAM name="Button" value="Icon:<i>path to .ico file</i>"&gt;</code>
</td>
<td>
Button with an icon.  
</td>
<td align="CENTER" valign="MIDDLE">
<OBJECT id=icon type="application/x-oleobject"
        classid="clsid:adb880a6-d8ff-11cf-9377-00aa003b7a11"
        width=100
        height=100
>
    <PARAM name="Command" value="HH Version">
    <PARAM name="Button" value="Icon:cd.ico">
</OBJECT>
</td>
<td>You can specify an absolute or relative path.
</td>
</tr>
</table>

<p>
<!------------insert example here-------------------->
<h2>Example</h2>

<p>The following example uses a button with a bitmap image to call the <b>HH Version</b> command. 

<p><pre><code>
&lt;OBJECT
<br>  id=bitmap
<br>  type="application/x-oleobject"
<br>  classid="clsid:adb880a6-d8ff-11cf-9377-00aa003b7a11"
<br>  codebase="HHCTRL.ocx#Version=4,72,8252,0"
<br>  width=100
<br>  height=100
<br>&gt;
<br>  &lt;PARAM name="Command" value="HH Version"&gt;
<br>  &lt;PARAM name="Button" value="Bitmap:bmpbutton.bmp"&gt;
<br>&lt;/OBJECT&gt;
</pre></code></p>

<!------------insert example here-------------------->

<h2>Comments</h2>
<ul>
<li>You can invoke a command using the <a href="ocx_mclick.htm">Click</a> method instead of a button.
<li>Be sure to include all graphic files in the <code>[FILES]</code> section of your HTML Help project (.hhp) file.
</ul>
</li>


<br>
<table border="0" cellpadding="0" cellspacing="4">
<tr>
<td valign="top"><a href="ocx_parameters.htm"><img src="proced.gif" alt="link to overview topic" border="0"></a>
</td>
<td><a href="ocx_parameters.htm">About parameters</A>
</td>
</tr>
<tr>
<td>&nbsp;</td>
</tr>
</table>

<!--start keywords--->

<!--end keywords--->

</BODY>
</HTML>
